SORCERER MONITOR, VERSION 1.1, UPDATE 
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A new Sorcerer Monitor program has been developed to 
fix the various and sundry bugs of the original Monitor. This 
new Monitor will be called Version 1.1. This document is 
intended to describe the bugs that existed in Version 1.0, 
their symptoms, the fixes implemented in Version 1.1, and any 
ramifications these modifications will have. All known bugs in 
Version 1.0 have been fixed. 

Important note: These modifications were made 
without moving any major routine or subroutine in the Monitor. 
All code which was added had a corresponding compression of 
existing code. The only exception to this is the subprocessor 
which supports the "T=n" parameter of the "SET" command which 
was moved 2 bytes. Thus the new Monitor should be total y 
upward compatible with. existing software such as ROM PAts, 
CP/M, etc. 

1 S YMPTOM : Neither Sorcerer I or II seem to work with an 
RS232 device on the serial port. For example, serial printers 
appear to hang or print garbage, af any baud rate. 

BUG- The 1.0 keyboard scan routine reset the serial 
port f^o"m RS232 mode to cassette mode every time it was invoked 
\o get a character. Thus the RS232 signal was immediately set 
to idle state, and the UART was shut down. So, in Sorcerer I, 
due to a problem in the UART control hardware which caused 
RS232 idle to be a space (+9V) and not a mark (-9V), the serial 
device was sent a long string of invalid inverted bits, anging 
it up. Sorcerer I's required a hardware mod to reverse this 
idle state logic (see 30-3160, pin 8B-9). In Sorcerer II. the 
above hardware problem was fixed, but the reset of the port to 
cassette still shut the UART down before a byte could be 
completely sent, causing lost characters and framing errors. 
This occurred at 300 or 1200 baud. Note the Dumb Terminal 
Program and the Word Processor work correctly (with hardware 
mod to Sore I) because thTT^ontain their own keyboard 

FIX* The 1.1 keyboard routine maintains the 
RS2327clssette^mode in its proper state. With this, Sorcerer 
I's no longer require the above hardware mod. 
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2. SYMPTOM ; 1200 baud sometimes loses characters or does not 
work at all, even with above hardware mod to Sore I. 

BUG ; 1.0 keyboard routine, error processing, motor 
control and elsewhere a lways re set b au d rate Jt o300 baud when 
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invoked. Dumb Term Prog and IfP^Pju^work again because they do 
not use these routines. 

FIX ; 1.1 routines maintain baud rate at all times. 
Note: 1200 baud still cannot work with printers with slow 
carriages due to data overruns unless application program sends 
nulls at end of line or Sorcerer is redesigned to handshake on 
the serial port. Using the SET S=6 command can be an expedient 
circumvention. 

3. SYMPTOM ; There is no convenient way to set RS232 mode 
from the monitor command level to use serial devices assuming 
serial devices work correctly. 

BUG ; 1.0 SET T=n command only sets baud rate. There 
is no command for chosing RS232 or cassette mode. 

FJ_X: 1.1 SET T=n has two new parameters for this 
purpose, as follows: C^~^J^CfO 

SET T = - 1200 baud cassette (unchanged) tyA rs- ft pee 
SET T=l - 300 baud cassette (unchanged) (pep t r t^~- 

SET T = 2 - 1200 baud RS232 ' (new) C<& " [IY +* p," 
SET T = 3 - 300- baud RS232 (new) <f$ " V J u ¥/ 
Note that the baud rate and the mode is now set " V- 

immediately upon completion of these commands, not later when fc? f 1 rv^- 

the motor is turned on as in 1.0 ~ ^ 
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4. SYMPTOM : SET 0=S (serial) only works at 300 baud, no 
matter what SET T=n parameter was used. 

BUG ; SET T=n did not actually set the baud rate, just 
"remember" it. Turning motor on did. Motor is never turned on 
unless cassette is used. 

FIX ; See #3 above. New SET T=n now actually sets the 
mode and baud rate. Thus to use a serial printer from the new 
Monitor, only the following sequence of commands is necessary: 

>SET T=2 (1200/RS232, or T=3 for 300) 
>SET 0=S (all output now goes to printer) 
Note that RS232 and cassette operations are mutually exclusive. 
Note also that the 1.1 Monitor together with Exidy CP/M 
Versions 1.42/3 and higher will allow CP/M communication with 
the serial RS232 port. Use the Monitor SET T=2 or 3 command, 
and then simply use the CP/M standard punch device PUN:. Eg, 
to list a file on CP/M, SET T=2 or 3, boot CP/M, and issue 

A>PIP PUN :'=FILENAME.EXT- 
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5. SYMPTOM : A user program initiated by the GO command hangs 
1.0 Monitor on RETURN if reg IY modified. 

BUG ; Command completion processing assumes IY is ok. 

FIX : 1.1 will do a full warm start after all command 
completion (including GO) to reset IY correctly. 



6. FIX : Logo updated to indicated Version 1.1 and new 
copyright date of 1979 



7. SYMPTOM : Tape read with tape positioned in middle of file 
containing a string of 00's incorrectly gives CRC ERROR instead 
of skipping file to next file leader. 

BUG : "TAPWT" file leader finder looks for at least 10 
00's, but allows any character following as an indication of 
the file leader (not just a 01). 

FIX : 1.1 routine only allows a 01 after at least 10 
00's. 



8. SYMPTOM : Standard graphics refreshed when CLEAR key 
depressed. Eg, this incorrectly destroys any programmed 
graphics when the screen is cleared. 

BUG : Refresh should only occur during a Monitor Cold 
Start not for a FORMFEED (CLEAR key). 

FI X : Video processing fixed not to refresh on screen 
clear, only on cold start. 

9. FIX : "PR" command removed from Monitor (allows 
changing prompt character ">"). Replaced by subroutine called 
"FOLD" at ROM address E845 hex. This routine, used by 1.1 
Monitor and available for external software use, takes a 
character in register A, and if lower case alpha, converts it 
to upper case. 

10* SYMPTOM : 1.0 command level keyboard input does not allow 
lower case. Very inconvenient, esp if using the WP PAC. 

BUG : 1.0 line input routine did not fold lower case. 

FIX : 1.1 routine now uses "FOLD" routine. Note lower 
case now echoes as upper case also. 

11. SYMPTOM : "TAB/SKIP" key only generates horizontal tab 
character (HT, Control-I , 09 hex) if shifted. Lower case use 
Incorrectly generates vertical tab (VT, Control-K, 0B hex). 
Very inconvenient since VT Is seldom used (not supported by any 
current Exidy software) while HT is used heavily in editors, 
etc • 

BUG : 1.0 key font definition table incorrect for non- 
shifted TAB/SKIP position 

FIX : 1.1 table should be updated from 0B to 09 codes. 
It cannot because then WP PACs which look for ~K will no longer 



work. Bug not fixed. 

12. FIX ; 1.1 cassette motor on and motor off processing 
updated and fixed to correctly maintain serial port baud rate 
and RS232/cas set te modes 

13. SYMPTOM : Cannot rubout graphics on Monitor command line. 
FIX : Not actually a bug. The graphics are only on 

the screen, not in the command (ie, they are not "there" to rub 
out). They are ignored, and rubouts are not needed. 
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